Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Dialog Box Messages

GXHandlePanelEvent

QuickDraw GX sends the GXHandlePanelEvent message when an event happens in a panel. You can override the GXHandlePanelEvent message to handle panel events that cannot be handled using 'xdtl' resources. Your override of the GXHandlePanelEvent message must match the following formal declaration:

OSErr MyHandlePanelEvent (gxPanelInfoRecord *aPanelInfoRecord,
                           gxPanelResult *panelResult);

aPanelInfoRecord

A pointer to the panel information structure that supplies information to the panel about the current dialog box and panel event.

panelResult

On return, the result of handling the panel event. This is one of the values described in the section "Panel Responses" on page 4-37.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXHandlePanelEvent message to allow a panel to handle events associated with the dialog box.

The default implementation of this message does nothing. You need to override
this message if you add panels that cannot be handled in a standard way
(using 'xdtl' resources).

SPECIAL CONSIDERATIONS

You never send the GXHandlePanelEvent message yourself.

You always perform a total override of the GXHandlePanelEvent message, in which you handle any events of interest that occur in your panel.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The panel information structure is described on page 4-35.

You can find an example of an overide of the GXHandlePanelEvent message in Listing 2-12 on page 2-22 in the chapter "Printing Extensions."

Print dialog boxes, panels, and the 'xdtl' resource are described in Inside Macintosh: QuickDraw GX Printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help